JavaScript Temporal API: Vaqt zonalarini hisobga olgan sana hisob-kitoblarini oʻzlashtiring

Bugungi oʻzaro bogʻlangan dunyoda ilovalarga tez-tez turli vaqt zonalarida sanalar va vaqtlarni boshqarish kerak boʻladi. Global elektron tijorat platformasini, rejalashtirish vositasini yoki moliyaviy ilovani yaratasizmi, aniq vaqt zonasini hisobga olgan sana hisob-kitoblari juda muhimdir. JavaScript, anʼanaviy ravishda, vaqt zonalari bilan ishlashda cheklovlarga ega edi, ammo yangi standart boʻlgan Temporal API bu muammolarni toʻgʻridan-toʻgʻri hal qiladi. Ushbu blog posti Temporal API-ni oʻrganadi, uning xususiyatlarini oʻrganadi va murakkab sana va vaqt operatsiyalarini aniqlik va qulaylik bilan qanday bajarishni koʻrsatadi.

JavaScript-da vaqt zonasini boshqarish muammolari

Temporal API-dan oldin, JavaScript dasturchilari oʻrnatilgan Date obʼektiga tayanishgan. Funktsional boʻlsa-da, Date obʼekti vaqt zonalari bilan ishlashda bir nechta kamchiliklarni keltirib chiqaradi:

• Nostabil xatti-harakat: Date obʼektining xatti-harakati brauzer yoki serverning mahalliy vaqt zonasi sozlamalariga qarab oʻzgaradi. Bu sana va vaqt koʻrinishlarini bashorat qilish va nazorat qilishni qiyinlashtiradi.
• Oʻzgaruvchan holat: Date obʼekti oʻzgaruvchan, yaʼni uning qiymatlarini toʻgʻridan-toʻgʻri oʻzgartirish mumkin. Bu kutilmagan yon taʼsirlarga olib kelishi va disk raskadrovka qilishni murakkablashtirishi mumkin.
• Aniq emaslik: Date obʼektining usullari noaniq boʻlishi va moʻljallangan vaqt zonasi yoki formatini aniqlashni qiyinlashtirishi mumkin.
• Vaqt zonalarini konvertatsiya qilish: Oʻrnatilgan usullar yordamida aniq vaqt zonalarini konvertatsiya qilish koʻpincha murakkab hisob-kitoblarni va uchinchi tomon kutubxonalarini talab qiladi, bu esa kodga murakkablik qoʻshadi.

Ushbu cheklovlar xatolarga olib kelishi mumkin, ayniqsa xalqaro foydalanuvchilar yoki turli vaqt zonalarida tadbirlarni rejalashtirishi kerak boʻlgan ilovalar bilan ishlashda. Misol uchun, uchrashuvlarni rejalashtiradigan ilovani koʻrib chiqing. Agar ilova vaqt zonalarini toʻgʻri boshqarmasa, turli joylardagi foydalanuvchilar jiddiy rejalashtirish ziddiyatlarini boshdan kechirishlari mumkin.

Temporal API bilan tanishtirish

Temporal API - bu JavaScript tili uchun yangi taklif boʻlib, hozirda TC39 jarayonining 3-bosqichida, yaʼni u standartga aylanish yoʻlida. U JavaScript-da vaqt zonalarini boshqarishni ham oʻz ichiga olgan holda, sanalar va vaqtlar bilan ishlashning mustahkam va intuitiv usulini taqdim etishni maqsad qiladi. Temporal mavjud Date obʼektiga nisbatan bir nechta afzalliklarni taklif qiladi:

• Oʻzgarmaslik: Temporal obʼektlari oʻzgarmasdir. Yaratilgandan soʻng, ularning qiymatlarini toʻgʻridan-toʻgʻri oʻzgartirib boʻlmaydi, bu esa xavfsizroq va bashorat qilinadigan kodni ragʻbatlantiradi.
• Aniq va aniq: API noaniqlikni kamaytiradigan sana va vaqt manipulyatsiyasi uchun aniq va aniq usullarni taqdim etadi.
• Vaqt zonasi qoʻllab-quvvatlashi: Temporal API vaqt zonalari uchun oʻrnatilgan yordamni taqdim etadi, bu turli vaqt zonalari oʻrtasida konvertatsiya qilishni va yozgi vaqtni (DST) boshqarishni osonlashtiradi.
• Soddalashtirilgan hisob-kitoblar: API umumiy sana va vaqt hisob-kitoblarini soddalashtiradi, masalan, kunlar, oylar yoki yillarni qoʻshish va ikki sana oʻrtasidagi farqni hisoblash.
• Zamonaviy dizayn: API zamonaviy va intuitiv boʻlishi uchun moʻljallangan boʻlib, dasturchilarga sanalar va vaqtlar bilan ishlashni osonlashtiradi.

Temporal API-dagi asosiy tushunchalar

Temporal API bir nechta yangi maʼlumotlar turlari va tushunchalarini taqdim etadi, ularni tushunish juda muhim:

• Temporal.Instant: Har qanday vaqt zonasiga bogʻliq boʻlmagan vaqtning aniq nuqtasini ifodalaydi. U Unix vaqt belgisiga asoslangan boʻlib, uni vaqt maʼlumotlarini saqlash va almashish uchun ideal qiladi.
• Temporal.ZonedDateTime: Vaqt zonasi bilan vaqtning aniq nuqtasini ifodalaydi. U vaqtni va vaqt zonasi ofsetini birlashtiradi.
• Temporal.PlainDate: Vaqt yoki vaqt zonasisiz aniq sanani (yil, oy, kun) ifodalaydi.
• Temporal.PlainTime: Sana yoki vaqt zonasisiz aniq vaqtni (soat, daqiqa, soniya va ixtiyoriy ravishda millisekundlar va mikrosekundlar) ifodalaydi.
• Temporal.PlainDateTime: Vaqt zonasisiz aniq sana va vaqtni ifodalaydi.
• Temporal.TimeZone: 'America/Los_Angeles' yoki 'Europe/London' kabi vaqt zonasini ifodalaydi.
• Temporal.Duration: '2 kun, 5 soat va 30 daqiqa' kabi vaqt davomiyligini ifodalaydi.

Temporal API bilan ishlashni boshlash

Temporal API hali barcha brauzerlar va Node.js versiyalarida mahalliy ravishda mavjud emas. Biroq, siz bugun API bilan tajriba oʻtkazishni boshlash uchun Temporal polyfill kabi polyfilldan foydalanishingiz mumkin. Ushbu polyfill standart bilan bir xil funksionallikni taʼminlaydi va kodingiz hatto mahalliy API-ni qoʻllab-quvvatlamaydigan muhitlarda ham ishlashini taʼminlaydi.

Temporal polyfillni npm yordamida oʻrnatish uchun quyidagilarni ishga tushiring:

            npm install @js-temporal/polyfill
            

              
                Copy
              
            
          

Keyin, JavaScript kodingizda siz polyfillni import qilishingiz va ishga tushirishingiz kerak:

            import { Temporal } from '@js-temporal/polyfill';

// Or, in a CommonJS environment:
// const { Temporal } = require('@js-temporal/polyfill');
            

              
                Copy
              
            
          

Polyfill oʻrnatilgandan va import qilingandan soʻng, siz Temporal API-dan foydalanishni boshlashingiz mumkin. Keling, baʼzi amaliy misollarni koʻrib chiqaylik.

Vaqt zonasini hisobga olgan sana hisob-kitoblarining amaliy misollari

1. ZonedDateTime yaratish

ZonedDateTime yaratish uchun sizga vaqt va vaqt zonasi kerak:

            import { Temporal } from '@js-temporal/polyfill';

const instant = Temporal.Instant.fromEpochSeconds(1678886400); // 2023-yil 15-mart 00:00:00 UTC
const timezone = Temporal.TimeZone.from('America/Los_Angeles');
const zonedDateTime = instant.toZonedDateTime(timezone);

console.log(zonedDateTime.toString()); // 2023-03-14T17:00:00-07:00[America/Los_Angeles]
            

              
                Copy
              
            
          

Ushbu misolda biz Unix vaqt belgisidan Temporal.Instant yaratamiz va keyin uni 'America/Los_Angeles' vaqt zonasida ZonedDateTime ga aylantiramiz. Eʼtibor bering, chiqish Los-Anjelesdagi mahalliy vaqtni aks ettiradi, vaqt zonasi ofsetini hisobga oladi.

2. Vaqt zonalari oʻrtasida konvertatsiya qilish

            import { Temporal } from '@js-temporal/polyfill';

const instant = Temporal.Instant.fromEpochSeconds(1678886400);
const losAngelesTimezone = Temporal.TimeZone.from('America/Los_Angeles');
const londonTimezone = Temporal.TimeZone.from('Europe/London');
const losAngelesZonedDateTime = instant.toZonedDateTime(losAngelesTimezone);

const londonZonedDateTime = losAngelesZonedDateTime.withTimeZone(londonTimezone);

console.log(londonZonedDateTime.toString()); // 2023-03-15T00:00:00+00:00[Europe/London]
            

              
                Copy
              
            
          

Bu erda biz ZonedDateTime ni Los-Anjelesdan Londonga aylantiramiz. Chiqish Londondagi ekvivalent vaqtni koʻrsatadi, vaqt farqi va har qanday DST tuzatishlarini hisobga oladi.

3. Vaqt farqlarini hisoblash

Ikki sana yoki vaqt oʻrtasidagi farqni hisoblash juda oson:

            import { Temporal } from '@js-temporal/polyfill';

const date1 = Temporal.PlainDate.from('2023-03-15');
const date2 = Temporal.PlainDate.from('2023-03-20');

const duration = date2.until(date1);

console.log(duration.toString()); // -P5D

const duration2 = date1.until(date2);

console.log(duration2.toString()); // P5D
            

              
                Copy
              
            
          

Ushbu misol PlainDate obʼektlari yordamida ikki sana oʻrtasidagi davomiylikni hisoblaydi. Natijada Duration obʼekti boʻladi, undan keyingi hisob-kitoblar uchun foydalanish mumkin.

4. Vaqtni qoʻshish va ayirish

            import { Temporal } from '@js-temporal/polyfill';

const now = Temporal.Now.zonedDateTime('America/New_York');
const tomorrow = now.add({ days: 1 });
const oneHourAgo = now.subtract({ hours: 1 });

console.log(tomorrow.toString());
console.log(oneHourAgo.toString());
            

              
                Copy
              
            
          

Ushbu kod 'America/New_York' vaqt zonasida hozirgi vaqtdan bir kun qoʻshish va bir soatni ayirishni koʻrsatadi. Temporal API DST oʻtishlarini bemalol boshqaradi.

5. Oddiy sanalar va vaqtlar bilan ishlash

Temporal API shuningdek, har qanday vaqt zonasiga bogʻliq boʻlmagan sanalar va vaqtlar bilan ishlash uchun PlainDate, PlainTime va PlainDateTime obʼektlarini taqdim etadi.

            import { Temporal } from '@js-temporal/polyfill';

const plainDate = Temporal.PlainDate.from('2023-10-27');
const plainTime = Temporal.PlainTime.from('14:30:00');
const plainDateTime = Temporal.PlainDateTime.from('2023-10-27T14:30:00');

console.log(plainDate.toString());     // 2023-10-27
console.log(plainTime.toString());     // 14:30:00
console.log(plainDateTime.toString()); // 2023-10-27T14:30:00
            

              
                Copy
              
            
          

Ushbu obʼektlar vaqt zonalarining murakkabligi holda aniq sanalar va vaqtlarni, masalan, tugʻilgan kunlar yoki tadbirning boshlanish vaqtlarini ifodalash uchun foydalidir.

Temporal API-dan foydalanish boʻyicha eng yaxshi amaliyotlar

Temporal API-dan foydalanganda eʼtiborga olish kerak boʻlgan baʼzi eng yaxshi amaliyotlar:

• Har doim vaqt zonalaridan foydalaning: Turli hududlarda dolzarb boʻlishi mumkin boʻlgan sanalar va vaqtlar bilan ishlaganda, har doim vaqt zonalaridan foydalaning. Bu noaniqlikning oldini oladi va aniqlikni taʼminlaydi.
• Maʼlumotlarni UTC-da saqlang: Sanalar va vaqtlarni maʼlumotlar bazasida yoki boshqa doimiy xotirada saqlash uchun vaqt zonasi bilan bogʻliq asoratlarni oldini olish uchun UTC (Koordinatsiyalangan universal vaqt) dan foydalaning.
• Koʻrsatish uchun konvertatsiya qiling: Sanalar va vaqtlarni faqat koʻrsatish maqsadlarida foydalanuvchining mahalliy vaqt zonasiga aylantiring.
• Oʻzgarmaslikdan foydalaning: Koʻproq bashorat qilinadigan va saqlanadigan kod yozish uchun Temporal obʼektlarining oʻzgarmasligidan foydalaning. Temporal obʼektlarini toʻgʻridan-toʻgʻri oʻzgartirishdan saqlaning.
• Toʻgʻri obʼekt turini tanlang: Ehtiyojlaringizga qarab tegishli Temporal obʼekt turini (Instant, ZonedDateTime, PlainDate va boshqalar) tanlang.
• DST oʻtishlarini boshqaring: Yozgi vaqt (DST) oʻtishlaridan va ularning sana va vaqt hisob-kitoblariga qanday taʼsir qilishidan xabardor boʻling. Temporal API DST-ni avtomatik ravishda boshqaradi, ammo tushunchani tushunish nosozliklarni bartaraf etishga yordam beradi.
• Foydalanuvchi tajribasini hisobga oling: Foydalanuvchi interfeyslarini loyihalashda vaqt zonalari va sana/vaqt formatlarini tanlash uchun aniq va intuitiv boshqaruv elementlarini taqdim eting. Foydalanuvchilarning mahalliy imtiyozlari va madaniy meʼyorlarini hisobga oling.

Temporal API-ning real dunyo ilovalari

Temporal API juda koʻp qirrali va koʻplab sohalar va ilovalarda qoʻllaniladi:

• Elektron tijorat: Turli vaqt zonalarida mahsulotni ishga tushirish vaqtlarini, reklama davrlarini va buyurtmalarni bajarishni boshqarish.
• Rejalashtirish va taqvim: Vaqt zonasi farqlarini hisobga olgan holda butun dunyo boʻylab foydalanuvchilar uchun uchrashuvlar, yigʻilishlar va tadbirlarni yaratish va boshqarish.
• Moliyaviy ilovalar: Turli moliyaviy bozorlarda sanalar va vaqtlarni oʻz ichiga olgan foiz stavkalarini hisoblash, tranzaktsiyalarni qayta ishlash va hisobotlarni yaratish.
• Sayohat va mehmondoʻstlik: Vaqt zonalari va sayohat sanalarini hisobga olgan holda reyslar, mehmonxonalar va tadbirlarni bron qilish.
• Loyihalarni boshqarish: Geografik jihatdan tarqalgan jamoalar oʻrtasida loyiha muddatlarini kuzatish, vazifalarni taqsimlash va taraqqiyotni monitoring qilish.
• Ijtimoiy media platformalari: Postlarni rejalashtirish va butun dunyo boʻylab foydalanuvchilar uchun toʻgʻri mahalliy vaqtda kontentni koʻrsatish.

Xulosa: JavaScript-da sana va vaqtning kelajagini qabul qilish

JavaScript Temporal API, ayniqsa global kontekstda sanalar va vaqtlar bilan ishlashning uzoq davom etgan muammolariga kuchli va foydalanuvchilarga qulay yechim taklif etadi. Uning oʻzgarmasligi, aniqligi va mustahkam vaqt zonasi yordami uni anʼanaviy Date obʼektiga nisbatan sezilarli yaxshilanishga aylantiradi. Temporal API-ni qabul qilib, dasturchilar koʻproq ishonchli, saqlanadigan va global miqyosda xabardor ilovalarni yaratishlari mumkin. Temporal API keng tarqalganligi sababli, u JavaScript-da sanalar va vaqtlarni qanday boshqarishimizni inqilob qiladi. Bugun Temporal API bilan tajriba oʻtkazishni boshlang va JavaScript ekotizimida sana va vaqtni manipulyatsiya qilish kelajagiga tayyorlaning.

API imkoniyatlarini chuqurroq tushunish uchun rasmiy Temporal API hujjatlarini oʻrganishni va taqdim etilgan misollar bilan tajriba oʻtkazishni oʻylab koʻring. Aniq, ravshan va foydalanish qulayligiga eʼtibor qaratgan Temporal API butun dunyo boʻylab JavaScript dasturchilari uchun ajralmas vositaga aylanishga tayyor.

Temporal API kuchini qabul qiling va butun dunyo boʻylab vaqt va sanalarni uzluksiz boshqaradigan ilovalarni yaratish imkoniyatini oching!